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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

TS 32.331 "Notification Log (NL) Integration Reference Point (IRP): Requirements" 

TS 32.332 "Notification Log (NL) Integration Reference Point (IRP): Information Service (IS)" 

TS 32.333 "Notification Log (NL) Integration Reference Point (IRP): Common Object Request Broker 

Architecture (CORBA) Solution Set (SS)" 

TS 32.335 "Notification Log (NL) Integration Reference Point (IRP): extensible Markup Language (XML) 

solution definitions" 
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Scope 



The present document specifies the CORBA Solution Set for the IRP whose semantics are specified in 3GPP TS 32.332 
[6] Notification Log IRP: Information Service. 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. 
Clause 5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. 
Clause 6 describes the notification interface containing the push method. Annex A contains the IDL specification. 

This Solution Set specification is related to TS 32.332 V7.0.X. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] OMG TC Document telecom/98-11-01: "OMG Notification Service". 

http://www.omg.org/technologv/documents/ 

[2] OMG CORBA Services: "Common Object Services Specification, Update: November 22, 1996" 

(Clause 4 contains the Event Service specification), http://www.omg.org/technologv/documents/ 

[3] 3GPP TS 32.3 11: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 

[5] 3GPP TS 32.303: " Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Common Object Request Broker Architecture 
(CORBA) Solution Set (SS)". 

[6] 3GPP TS 32.332: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP): Information Service (IS)". 

[7] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

Management; Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.332 [6] apply. 
IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [3] subclause 3.1. 
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3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

MOC Managed Object Class 

MOI Managed Object Instance 

NE Network Element 

OMG Object Management Group 



4 Architectural Features 

The overall architectural feature of Notification Log IRP is specified in 3GPP TS 32.332 [6]. This clause specifies 
features that are specific to the CORBA SS. 



4.1 



Notification Services 



In implementations of CORBA SS, IRP Agent conveys Notification Log notifications to IRPManager via OMG 
Notification Service (OMG Notification Service [1]). 

OMG Event Service [2] provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality Of Service (QOS). 

A necessary and sufficient subset of OMG Notification Services shall be used to support Notification Log notifications 
as specified in 3GPP TS 32.332 [6]. 

These operation are classified as «AgentInternal-usage» in GPP TS 32.332 [6]. 



5. IVIapping 

5.1 Operation and Notification mapping 

3GPP TS 32.332 [6] defines semantics of operations and notifications visible across the Notification Log IRP. 

The following table indicates the mapping of these operations and notifications to their equivalents defined in this SS. 

Table 5.1.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 
3GPP TS 32.332 [6] 


SS Method 


Qualifier 


subscribeLog 


subscribe log 


M 


unsubscribeLog 


unsubscribe log 


M 


exportLog Records 


export log records 





getLog Records 


get log records 





getLogSubscriptionlds 


get log subscription ids 





getLogSubscriptionStatus 


get log subscription status 





notifyLogSubscribed 


push_structured_event (note 1). See clause 4.1 . 
See interface NotifyLogSubscribed 


M 


notifyLogUnsubscribed 


push_structured_event (note 1). See clause 4.1 . 
See interface NotifyLogUnubscribed 


M 


notifyOccupancyLevelCrossed 


push_structured_event (note 1). See clause 4.1 . 
See interface NotifyLogOccupancyLevelCrossed 





notifyLoggingResumed 


push_structured_event (note 1). See clause 4.1 . 
See interface NotifyLoggingResumed 





NOTE: OMG Notification Service OIVIG Notification Service [1] defines this method. 
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5.2 Operation parameter mapping 



3GPP TS 32.332 [6] defines semantics of parameters carried in operations across the Notification Log IRP. 

The following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 5.2.1 : Mapping from IS subscribeLog parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld logSubscriptionld 


M 


loggingEndTlme 


GenericlRPIVIanagementConstDefs::IRPTime 
loggingEndTimeAsked 





notificationCategories 


GenericlRPIVIanagementConstDefs::NotlficationCategorySet 
notificationCategorySet 





filter 


GenericlRPManagementConstDefs::StringOpt filter 





logManagerToken 


NotificationLoglRPGonstDefs::LogManagerTokenOpt 
logl\/lanagerToken; 





loggingEndTime 


GenericlRPManagementConstDefs::loggingEndTimeGiven 





status 


GenericlRPManagementConstDefs::Signal 

Exceptions: 

SubscribeLog, GenericlRPManagementSystem::lnvalidParameter, 

GenericI RPManagementSystem : iParameterNotSupported, 

GenericlRPManagementSystem::ValueNotSupported, 

InvalidLogSubscriptionId, UnknownLogManagerToken. 


M 



Table 5.2.2: Mapping from IS unsubscribeLog parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPGonstDefs::LogSubscriptionld logSubscriptionld 


M 


logManagerToken 


NotificationLoglRPConstDefs::LogManagerTokenOpt 
loglVlanagerloken 





status 


GenericlRPIVIanagementConstDefs::Signal 

Exceptions: 

UnsubscribeLog, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ParameterNotSupported, 

UnknownLogSubscriptionId, UnknownLogManagerToken). 


M 



Table 5.2.3: Mapping from IS exportLogRecords parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPGonstDefs::LogSubscriptionld logSubscriptionld 


M 


notificationCategories 


NotificationLoglRPGonstDefs::NotificationCategorySetOpt 
notificationGategorySet 





filter 


GenericlRPManagementGonstDefs::StringOpt filter 





invocationid 


string invocationid 


M 


status 


GenericlRPManagementGonstDefs::Signal 

Exceptions: 

ExportLogRecords, GenerJclRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::OperationNotSupported, 

UnknownLogSubscriptionId. 


M 
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Table 5.2.4: Mapping from IS getLogRecords parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


logSubscriptionld 


NotificationLoglRPConstDefs::LogSubscriptionld 
logSubscriptionld 


M 


notificationCategories 


NotificationLoglRPConstDefs::NotificationCategorySetOpt 
notificationCategories, 





filter 


GenericlRPManagementConstDefs::StringOpt filter 





getLogRecordsResult 


Some or all of the information contained in getLogRecordsResult 
will be returned via the return value of type 
DsLogAdmin::RecordList. 


M 


status 


Exceptions: 

GetLogRecords, 

Generic! RPManagementSystem::lnvalidParameter, 

GenericlRPIVIanagementSystem::ParameterNotSupported, 

Generic! RPIVlanagementSystem::ValueNotSupported, 

GenericlRPIVlanagementSystem::OperationNotSupported, 

Unl<nownLogSubscription!d. 


!VI 



Table 5.2.5: lUlapping from IS getLogSubscriptionids parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


logSubscriptionlds 


return value of type DsLogAdmin;:LogldList 


IVI 


status 


Exceptions: 

GetLogSubscriptionids, 

Generic!RPIVIanagementSystem::OperationNotSupported. 


M 



Table 5.2.6: lUlapping from IS getLogSubscriptionStatus parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


logSubscriptionld 


NotificationLog!RPConstDefs::LogSubscription!d 
logSubscriptionld 


M 


logAttributeList 


NotificationLog!RPConstDefs::LogAttributeList logAttributeList 


IVI 


status 


Generic!RPIVIanagementConstDefs::Signal 

Exceptions: 

GetLogSubscriptionStatus, 

Generic!RPI\/lanagementSystem::lnvalidParameter, 

Generic!RPIVIanagementSystem::OperationNotSupported. 


M 



5.3 Notification parameter mapping 



3GPP TS 32.332 [6] defines semantics of parameters carried in notifications. The following tables indicate the mapping 
of these parameters to their OMG CORBA Structured Event (defined in OMG Notification Service [1]) equivalents. 
The composition of OMG Structured Event, as defined in the OMG Notification Service [1], is: 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f i Iter able_body_fie Ids 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the 
3GPP TS 32.332 [6] defined notification parameters. 
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Table 5.3.1 : Mapping for notifyLogSubscribed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See sub-clause 3.3. 
It indicates the syntax and semantics of the Structured Event as defined by 
this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotlflcations:: NotifyLogSubscribed:: 
NOTIFY LOG SUBSRIBED. 


There is no 
corresponding IS 
parameter. 


event_name 


M 


Null-string 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV (note 1) pair 

of 

filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
NOTIFICATIONJD. 

Value of NV pair is a long. 


eventTlme 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
EVENT_TIME. 

Value of NV pair is of type GenericlRPIVIanagementConstDefs::IRPTime. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::LOG_SUBSCRIPT10N_ID. 

Value of NV pair is of type NotificationLoglRPConstDefs::LogSubscriptionld. 


loggingEndTime 


One NV pair of 
remaining_body 





Name of NV pair is the 
NotificationLoglRPNotifications::NotifyLogSubscribed::LOGGING_END_TIME. 

Value of NV pair is a string. 


notificationCategories 


One NV pair of 
remaining_body 





Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::NOTIFICATION_CATEGORIES. 

Value of NV pair is of type 
GenericlRPI\/lanagementConstDefs::VersionNumberSet. 


filter 


One NV pair of 
remaining_body 





Name of NV pair is notificationLoglRPNotifications:: NotifyLogSubscribed:: 
FILTER 

Value of NV pair is a string. 


NOTE: NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded 
in string. This note is applicable to all NV-pairs and all mapping tables for all notifications. 
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Table 5.3.2: Mapping for notifyLogUnsubscribed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See 
sub-clause 3.3. 

It indicates the syntax and semantics of the Structured 
Event as defined by this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: NOTIFY LOG UNSUBSCRIBED. 


There is no 
corresponding IS 
parameter. 


event_name 


M 


Null-string. 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::NOTIFICATION_ID. 

Value of NV pair is a long. 


eventTime 


One NV pair of One NV 
pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: EVENT_TIME. 

Value of NV pair is a IRPTime of module 
GenericlRPManagementConstDefs. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
filterable_body_fields 
(editor note) 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type 
NotificationLoglRPConstDefs::LogSubscriptionld. 



Editor note: The placement of this parameter in fiherable_body_fields so that it is fiherable is not yet aligned with 
current IS and require further discussion. 



ETSI 



3GPP TS 32.333 version 7.0.0 Release 7 



11 



ETSI TS 132 333 V7.0.0 (2007-06) 



Table 5.3.3: Mapping for notifyOccupancyLevelCrossed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See 
sub-clause 3.3. 

It indicates the syntax and semantics of the Structured 
Event as defined by this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: 

NotifyLogSubscribed:: 

NOTIFY LOG OCCUPANCY LEVEL CROSSED. 


There is no 
corresponding IS 
parameter 


event_name 


M 


Null-string 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV 
pairs is not significant. The name of NV-pair is always 
encoded in string. 

Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue::NOTIFICATION_ID. 

Value of NV pair is a long. 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: EVENT_TIME. 

Value of NV pair is a IRPTime of module 
GenericlRPIVIanagementConstDefs. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: 
AttributeNameValue:: SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptlonld 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type 
NotificationLoglRPConstDefs::LogSubscriptionld. 


currentOccupancyLevel 


One NV pair of One NV 
pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: CURRENT_OCCUPANCY_LEVEL. 

Value of NV pair is an unsigned short (i.e. DsLogAdmin:: 
Threshold). 


logFullAction 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed:: LOG_FULL_ACTION. 

Value of NV pair is of type NotificationLoglRPConstDefs:: 
LogFullActionType. 
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Table 5.3.4: Mapping for notifyLoggingResumed 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
parameter. 


domain_name 


M 


It carries the IRP document version number string. See sub-clause 3.3. 
It indicates the syntax and semantics of the Structured Event as defined by 
this specification. 


notificationType 


type_name 


M 


This is the NotificationLoglRPNotifications:: NotifyLogSubscribed:: 
NOTIFY LOG SUBSRIBED. 


There is no 
corresponding IS 
parameter. 


event_name 


M 


Null-string 


There is no 
corresponding IS 
parameter. 


variable Header 






objectClass, 
objectlnstance 


One NV (note 1) pair 

of 

filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs;: AttributeNameValue:: 
MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
NOTIFICATIONJD. 

Value of NV pair is a long. 


eventTlme 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
EVENT_TIME. 

Value of NV pair is of type GenericlRPManagementConstDefs::IRPTime. 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the NotificationlRPConstDefs:: AttributeNameValue:: 
SYSTEM_DN 

Value of NV pair is a string. 


logSubscriptionld 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::LOG_SUBSCRIPTION_ID. 

Value of NV pair is of type NotificationLoglRPConstDefs::LogSubscriptionld. 


loggingEndTime 


One NV pair of 
remaining_body 





Name of NV pair is the 
NotificationLoglRPNotifications::NotifyLogSubscribed::LOGGING_END_TIME. 

Value of NV pair is a string. 


notificationCategories 


One NV pair of 
remaining_body 





Name of NV pair is the NotificationLoglRPNotifications:: 
NotifyLogSubscribed::NOTIFICATION_CATEGORIES. 

Value of NV pair is of type 
GenericlRPManagementConstDefs::VersionNumberSet. 


filter 


One NV pair of 
remaining_body 





Name of NV pair is notificationLoglRPNotifications:: NotifyLogSubscribed:: 
FILTER 

Value of NV pair is a string. 


NOTE: NV stands for name-value pair. Order arrangement of NV pairs is not significant. The name of NV-pair is always encoded 
in string. This note is applicable to all NV-pairs and all mapping tables for all notifications. 
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6 NotificationLoglRPNotifications Interface 

OMG CORBA Notification push operation is used to realise the notification of 

Notif icationLoglRPNotif ications. All the notifications in this interface are implemented using this 

push_structured_event method. 



6.1 Method push (M) 



module CosNotifyComm ( 

Interface SequencePushConsumer ; Notif yPublish ( 
void push_structured_events ( 

in CosNotif ication: :EventBatch notifications) 

raises ( CosEventComm: : Disconnected) ; 



}; // SequencePushConsumer 



}; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [1]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

"NotificationLoglRPConstDefs.idl") 

// File: Notif icationLoglRPConstDef s . idl 

#ifndef _NOTIFICATIONLOGIRPCONSTDEFS_IDL_ 
#define _NOTIFICATIONLOGIRPCONSTDEFS_IDL_ 

#ifndef _DSLOGADMIN_IDL_ 
#define _DSLOGADMIN_IDL_ 
tinclude <DsLogAdmin. idl> 
#endif // _DSLOGADMIN_IDL_ 

#include "Notif icationlRPConstDefs . idl" 
#include "GenericIRPManagementConstDef s . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module NotificationLoglRPConstDefs 
{ 

typedef DsLogAdmin; ; Logid LogSubscriptionId; 
typedef DsLogAdmin; ;RecordId Recordid; 
typedef DsLogAdmin; ;RecordIdList RecordldList ; 

typedef string LogManagerToken; 

/* 

LogManagerTokenOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present; else absent. 

*/ 

union LogManagerTokenOpt switch (boolean) 

{ 

case TRUE; LogManagerToken value; 



/* 

IRPTimeOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present; else absent. 

*/ 

union IRPTimeOpt switch (boolean) 

{ 

case TRUE; GenericIRPManagementConstDef s ;; IRPTime value; 



typedef GenericIRPManagementConstDef s ; ; VersionNumberSet 

Notif icationCategory Set; 
/* 

Notif icationCategorySetOpt is a type carrying an optional parameter. 
If the boolean is TRUE, then the value is present; else absent. 
*/ 

union Notif IcationCategorySetOpt switch (boolean) 
{ 

case TRUE; Notif icationCategorySet value; 



enum LogState { LOGGING, LOGFULL, STOPPED}; 

typedef DsLogAdmin; ; CapacityAlarmThresholdList 
CapacityAlarmThresholdList ; 

typedef unsigned short LogFullActionType; 
const LogFullActionType wrap = 0; 
const LogFullActionType halt = 1; 
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/* 

IteratorOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present; else absent. 

*/ 

union IteratorOpt switch (boolean) 

{ 

case TRUE; DsLogAdmin ;; Iterator value; 

}; 

struct LogAttributes { 

LogSubscriptionId logSubscriptionld; 

GenericIRPManagementConstDef s : : IRPTime loggingEndTime; 

unsigned long long maxSize; 

unsigned long long currentSize; 

LogState logState; 

unsigned long long logRecordCount; 

Notif icationlRPConstDef s : : Notif icationCategorySet notif icationCategories; 

string filter; 

LogFullActionType logFullAction; 

CapacityAlarmThresholdList occupancyLevels; 

}; 

typedef sequence <LogAttributes> LogAttributeList; 

); 



#endif // _NOTIFICATIONLOGIRPCONSTDEFS_IDL_ 
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A.2 IDL specification (file name 'NotificationLoglRPSystem.idr) 

// File: Notif icationLoglRPSystem. idl 

#ifndef _NOTIFICATIONLOGIPRSYSTEM_IDL_ 
#define _NOTIFICATIONLOGIRPSYSTEM_IDL_ 

#include "Notif icationLoglRPConstDefs . idl" 

tinclude "GenericIRPManagementSystem. idl" 

tinclude <TimeBase . idl> 

#ifndef _DSLOGADMIN_IDL_ 

#define _DSLOGADMIN_IDL_ 

#include <DsLogAdmin. idl> 

#endif // _DSLOGADMIN_IDL_ 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module Notif icationLoglRPSystem 
{ 

/* 

System fails to complete the method. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP . 

V 

exception SubscribeLog { string reason; }; 

exception UnsubscribeLog ( string reason; }; 

exception ExportLogRecords ( string reason; }; 

exception GetLogSubscriptionlds { string reason; }; 

exception GetLogRecords { string reason; }; 

exception GetLogSubscriptionStatus { string reason; }; 

exception InvalidLogSubscriptionId ( string reason; }; 

exception UnknownLogSubscriptionId (}; 

exception UnknownLogManagerToken {}; 

exception InvalidConstraint ( string reason; }; 



interface Notif icationLogIRP : GenericIRPManagementSystem: : 

Generic IRPManagement 
{ 

GenericIRPManagementConstDef s :: Signal subscribe_log ( 

in Notif icationLoglRPConstDef s : : LogSubscriptionId logSubscriptionld, 
in Notif IcationLoglRPConstDef s :: IRPTimeOpt loggingEndTimeAsked, 
in Notif IcationLoglRPConstDef s : : Notif icationCategorySetOpt 

notif icationCat ego ry Set, 
in GenericIRPManagementConstDef s :: StringOpt filter, 
out Notif IcationLoglRPConstDef s : : LogSubscriptionld 

logSubscriptionldOut, 
out Notif IcationLoglRPConstDef s : : LogManagerTokenOpt logManagerToken, 
out Notif IcationLoglRPConstDef s :: IRPTimeOpt loggingEndTimeGiven 
) 
raises ( SubscribeLog, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : ParameterNot Supported, 
GenericIRPManagementSystem: :ValueNot Supported, 
InvalidLogSubscriptionId, UnknownLogManagerToken 



GenericIRPManagementConstDef s :: Signal unsubscribe_log ( 

in Notif IcationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 
in Notif IcationLoglRPConstDef s : : LogManagerTokenOpt logManagerToken 
) 
raises ( UnsubscribeLog, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : ParameterNot Supported, 
UnknownLogSubscriptionId, UnknownLogManagerToken) ; 

GenericIRPManagementConstDef s :: Signal export_log_records ( 

in Notif IcationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 
in Notif IcationLoglRPConstDef s : : Notif IcationCategorySetOpt 

notif icationCat ego ry Set, 
in GenericIRPManagementConstDef s :: StringOpt filter, 
out string invocationid 
) 
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raises ( ExportLogRecords, 

Gene ricIRPManagement System: 
Gene ricIRPManagement System: 
GenericIRPManagement System: 
UnknownLogSubscriptionId) ; 



: InvalidParameter, 

; ParameterNotSupported, 

lOperationNotSupported, 



// If some but not all of the information is returned via the return value 
// RecordList, then the rest of the information is returned via the 
// iterator. Otherwise, the iterator is absent. 
// 
DsLogAdmin: : RecordList get_log_records ( 

in Notif icationLoglRPConstDef s : : LogSubscriptionId logSubscriptionld, 
in Notif IcationLoglRPConstDef s : : Notif icationCategorySetOpt 

notif icationCat ego ries, 
in GenericIRPManagementConstDef s : : StringOpt filter, 
out Notif IcationLoglRPConstDef s :: IteratorOpt iterator 
) 
raises ( GetLogRecords, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : ParameterNotSupported, 
GenericIRPManagementSystem: :ValueNot Supported, 
GenericIRPManagementSystem: : Ope r at ionNot Supported, 
UnknownLogSubscriptionId) ; 



DsLogAdmin: :LogIdList get„log_subscription_ids () 
raises ( GetLogSubscriptionlds, 

GenericIRPManagementSystem: : Ope rat ionNot Supported 
); 



GenericIRPManagementConstDef s : : Signal get_log_subscription_status ( 

in Notif icationLoglRPConstDef s : : LogSubscriptionld logSubscriptionld, 

out Notif IcationLoglRPConstDef s : : LogAttributeList logAttributeList 

) 

raises ( GetLogSubscriptionStatus, 

GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : Ope rat ionNot Supported 
); 



#endif // _NOTIFICATIONLOGIPRSYSTEM_IDL_ 
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A.3 IDL specification (file name 

'NotificationLoglRPNotifications.idI') 

// File: Notif icationLoglRPNotif ications . idl 

#ifndef _NOTIFICATIONLOGIRPNOTIFICATIONS_IDL_ 
#define _NOTIFICATIONLOGIRPNOTIFICATIONS_IDL_ 

#include "Notif icationlRPNotif ications . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module Notif icationLoglRPNotif ications 
{ 

interface NotifyLogSubscribed; Notif icationlRPNotif ications : :Notify 
{ 

const string NOTIFY_LOG_SUBSRIBED = "xl"; 

const string LOG_SUBSCRIPTION_ID = "id"; 

const string LOGGING_END_TIME = "loggingEndTime" ; 

const string NOTIFICATION_CATEGORIES = "categories"; 

const string FILTER = "filter"; 

}; 

interface NotifyLogUnubscribed; Notif icationlRPNotif ications : :Notify 
{ 

const string NOTIFY_LOG_UNSUBSCRIBED = "x2"; 

const string LOG_SUBSCRIPTION_ID = "id"; 

}; 

interface Notif yLogOccupancyLevelCrossed: 

Notif icationlRPNotif ications : : Notify 
{ 

const string NOTIFY_LOG_OCCUPANCY_LEVEL_CROSSED = "x3"; 

const string LOG_SUBSCRIPTION_ID = "id"; 

const string CURRENT_OCCUPANCY_LEVEL = "level"; 

const string LOG_FULL_ACTION = "fullAction" ; 

); 

interface NotifyLoggingResumed; Notif icationlRPNotif ications ; ;Notify 
{ 

const string NOTIFY_LOGGING_RESUMED = "x4"; 

const string LOG_SUBSCRIPTION_ID = "id"; 

}; 

}; 

#endif // _NOTIFICATIONLOGIRPNOTIFICATIONS_IDL_ 
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